TopoShape API/de

Other languages:
(November 2018) Diese Information kann unvollständig und veraltet sein. Für die letzte API siehe die (engl.) autogenerierte API-Dokumentation.

Das TopoShape ist das Mutterobjekt des Part-Moduls. Alle Formtypen (Linienzug, Fläche, Volumen usw.) des Part-Moduls sind TopoShapes und haben die folgenden Attribute und Methoden gemeinsam. Beispiel: 

import Part
sh = Part.makeBox(10,10,10)
print sh.Faces
for f in sh.Faces:
   print f.Edges
Area

Returns: Die Gesamtfläche der Seiten der Form.

BoundBox

Returns: Die Begrenzungsbox des Objekts

CenterOfMass

Returns: Der Schwerpunkt des aktuellen Systems. Bei einem gleichmäßigen Gravitationsfeld entspricht dies dem Schwerpunkt. Die für den Schwerpunkt zurückgegebenen Koordinaten werden im absoluten kartesischen Koordinatensystem angegeben.

CompSolids

Returns: Listet die nachfolgenden Formen in dieser Form auf.

Compounds

Returns: Listet die Verbindungen in dieser Form auf.

Edges

Returns: Listet die Kanten in dieser Form auf.

Faces

Returns: Listet die Flächen in dieser Form auf.

Length

Returns: Gesamtlänge der Kanten der Form.

Matrix

Returns: Die gegenwärtige Transformation des Objekts als Matrix

Orientation

Returns: Die Ausrichtung der Form.

Placement

Returns: Die gegenwärtige Transformation des Objekts als Platzierung

ShapeType

Returns: Die Art der Form.

Shells

Returns: Listet die nachfolgenden Formen in dieser Form auf.

Solids

Returns: Liste der nachfolgenden Formen in dieser Form.

Vertexes

Returns: Liste der Eckpunkte dieser Form.

Volume

Returns: Gesamtvolumen der Feststoffe der Form.

Wires

Returns: Liste der Linienzüge in dieser Form.

approximate( )

Description: Nähert sich einer B-Spline-Kurve aus diesem Draht an

Returns: ein BSplineCurve-Objekt

check( )

Description: Überprüft die Form und meldet Fehler in der Formstruktur. Dies ist eine detailliertere Überprüfung als in isValid().

Returns:

common(TopoShape)

Description: Schnittpunkt dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

complement( )

Description: Berechnet das Komplement der Ausrichtung dieser Form, d. h. kehrt den Innen-/Außenstatus der Grenzen dieser Form um.

Returns: eine TopoShape

copy( )

Description: Erstellt eine Kopie dieser Form.

Returns: eine TopoShape

cut(TopoShape)

Description: Unterschied zwischen dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

distToShape( TopoShape )

Description: Berechnet den Mindestabstand zwischen diesem und einem bestimmten TopoShape.

Returns: float<minimum distance>,list<nearest points>,list<nearest subshapes & parameters>

exportBrep( string )

Description: Exportiert den Inhalt dieser Form in eine BREP-Datei. BREP ist ein natives Format von CasCade.

Returns:

exportIges( string )

Description: Exportiert den Inhalt dieser Form in eine IGES-Datei.

Returns:

exportStep( string )

Description: Exportiert den Inhalt dieser Form in eine STEP-Datei.

Returns:

exportStl( string )

Description: Exportiert den Inhalt dieser Form in eine STL-Netzdatei.

Returns:

extrude(Vector)

Description: Extrudiert die Form entlang einer Richtung.

Returns: eine TopoShape

fuse(TopoShape)

Description: Vereinigung dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

getAllDerivedFrom( )

Description: Gibt alle Teilsätze dieses Objekttyps zurück.

Returns: eine Liste

hashCode( )

Description: Dieser Wert wird aus dem Wert der zugrunde liegenden Formreferenz und der Position berechnet. Die Ausrichtung wird nicht berücksichtigt.

Returns: Eine Zeichenkette

isClosed( )

Description: Überprüft, ob die Form geschlossen ist.

Returns: Ein boolescher Wert

isDerivedFrom(string)

Description: Gibt „true“ zurück, wenn der angegebene Typ ein Vater ist.

Returns: Boolescher Wert

isEqual(TopoShape)

Description: Gibt wahr zurück, wenn beide Formen dieselbe TShape-Form, dieselbe Position und dieselbe Ausrichtung haben.

Returns: ein Boolescher Wert

isInside(Vector,float,Boolean)

Description: Prüft, ob ein Punkt innerhalb eines Volumenkörpers mit einer bestimmten Toleranz liegt. Wenn der dritte Parameter wahr ist, wird ein Punkt auf einer Fläche als innerhalb liegend betrachtet.

Returns: ein Boolescher Wert

isNull( )

Description: Überprüft, ob die Form null ist.

Returns: ein Boolescher Wert

isPartner(TopoShape)

Description: Returns true if both shapes share the same TShape, but may have a different Location and may have a different Orientation.

Returns: ein Boolescher Wert

isSame(TopoShape)

Description: Checks if both shapes share the same geometry, true if both shapes share the same TShape, have the same Location but may have a different Orientation.

Returns: ein Boolescher Wert

isValid( )

Description: Checks if the shape is valid, i.e. neither null, nor empty nor corrupted.

Returns: ein Boolescher Wert

makeFillet(float,TopoShape)

Description: Returns a new object based on TopoShape, but with a fillet of radius 'float' applied to each edge.

Returns: a TopoShape

makeHomogenousWires(wire)

Description: Makes this and the given wire homogenous to have the same number of edges

Returns: a wire

makeOffset(float)

Description: Offsets the shape by a given ammount

Returns: a TopoShape

makePipe(wire)

Description: Makes a pipe by sweeping along a wire.

Returns: a TopoShape

makePipeShell(wire)

Description: Makes a loft defined by profiles along a wire.

Returns: a TopoShape

makeShapeFromMesh(mesh)

Description: Makes a compound shape out of mesh data. Note: This should be used for rather small meshes only.

Returns: a TopoShape

makeThickness(list,float,float)

Description: A hollowed solid is built from an initial solid and a set of faces on this solid, which are to be removed. The remaining faces of the solid become the walls of the hollowed solid, their thickness defined at the time of construction. The arguments to be passed are a list of faces to be skipped, the thickness of the walls and a tolerance value.

Returns: a TopoShape

nullify( )

Description: Destroys the reference to the underlying shape stored in this shape. As a result, this shape becomes null.

Returns:

project(TopoShape)

Description: Project a shape on this shape

Returns: a TopoShape

read(string)

Description: Reads in an IGES, STEP or BREP file.

Returns: a TopoShape

reverse( )

Description: Reverses the orientation of this shape.

Returns:

revolve(Vector, Vector, float)

Description: Revolves the shape around a Axis to a given degree. ex: Part.revolve(Vector(0,0,0),Vector(0,0,1),360) revolves the shape around the Z Axis 360 degree.

Returns: a TopoShape

rotate(Vector<position>, Vector<direction>, float<angle>)

Description: Rotates this shape by angle degrees around an axis specified by position and direction. ex: Shp.rotate(Vector(0,0,0),Vector(0,0,1),180) rotate the shape around the Z Axis 180 degrees.

Returns:

scale(float<factor>, [Vector<centre>])

Description: Uniformly scales this shape by factor. Optionally specify centre of scaling transformation.

Returns:

section(TopoShape)

Description: Section of this with a given topo shape.

Returns: a TopoShape

sewShape( )

Description: Sews the shape if there is a gap.

Returns:

tessellate(float)

Description: Tessellate the the shape and return a list of vertices and face indices. The given float is the tolerance.

Returns: a list

toNurbs( )

Description: Conversion of the complete geometry of a shape into NURBS geometry. For example, all curves supporting edges of the basis shape are converted into BSpline curves, and all surfaces supporting its faces are converted into BSpline surfaces.

Returns: a NURBS curve

transformGeometry(matrix)

Description: Applies geometric transformation on a copy of the shape. The transformation to be applied is defined as a 4x4 matrix. The underlying geometry of the following shapes may change to a curve which supports an edge of the shape, or a surface which supports a face of the shape. For example, a circle may be transformed into an ellipse when applying an affinity transformation. It may also happen that the circle then is represented as a b-spline curve. The transformation is applied to all the curves which support edges of the shape, and all the surfaces which support faces of the shape. Note: If you want to transform a shape without changing the underlying geometry then use the methods translate or rotate.

Returns: a
Area

Returns: Die Gesamtfläche der Seiten der Form.

BoundBox

Returns: Die Begrenzungsbox des Objekts

CenterOfMass

Returns: Der Schwerpunkt des aktuellen Systems. Bei einem gleichmäßigen Gravitationsfeld entspricht dies dem Schwerpunkt. Die für den Schwerpunkt zurückgegebenen Koordinaten werden im absoluten kartesischen Koordinatensystem angegeben.

CompSolids

Returns: Listet die nachfolgenden Formen in dieser Form auf.

Compounds

Returns: Listet die Verbindungen in dieser Form auf.

Edges

Returns: Listet die Kanten in dieser Form auf.

Faces

Returns: Listet die Flächen in dieser Form auf.

Length

Returns: Gesamtlänge der Kanten der Form.

Matrix

Returns: Die gegenwärtige Transformation des Objekts als Matrix

Orientation

Returns: Die Ausrichtung der Form.

Placement

Returns: Die gegenwärtige Transformation des Objekts als Platzierung

ShapeType

Returns: Die Art der Form.

Shells

Returns: Listet die nachfolgenden Formen in dieser Form auf.

Solids

Returns: Liste der nachfolgenden Formen in dieser Form.

Vertexes

Returns: Liste der Eckpunkte dieser Form.

Volume

Returns: Gesamtvolumen der Feststoffe der Form.

Wires

Returns: Liste der Linienzüge in dieser Form.

approximate( )

Description: Nähert sich einer B-Spline-Kurve aus diesem Draht an

Returns: ein BSplineCurve-Objekt

check( )

Description: Überprüft die Form und meldet Fehler in der Formstruktur. Dies ist eine detailliertere Überprüfung als in isValid().

Returns:

common(TopoShape)

Description: Schnittpunkt dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

complement( )

Description: Berechnet das Komplement der Ausrichtung dieser Form, d. h. kehrt den Innen-/Außenstatus der Grenzen dieser Form um.

Returns: eine TopoShape

copy( )

Description: Erstellt eine Kopie dieser Form.

Returns: eine TopoShape

cut(TopoShape)

Description: Unterschied zwischen dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

distToShape( TopoShape )

Description: Berechnet den Mindestabstand zwischen diesem und einem bestimmten TopoShape.

Returns: float<minimum distance>,list<nearest points>,list<nearest subshapes & parameters>

exportBrep( string )

Description: Exportiert den Inhalt dieser Form in eine BREP-Datei. BREP ist ein natives Format von CasCade.

Returns:

exportIges( string )

Description: Exportiert den Inhalt dieser Form in eine IGES-Datei.

Returns:

exportStep( string )

Description: Exportiert den Inhalt dieser Form in eine STEP-Datei.

Returns:

exportStl( string )

Description: Exportiert den Inhalt dieser Form in eine STL-Netzdatei.

Returns:

extrude(Vector)

Description: Extrudiert die Form entlang einer Richtung.

Returns: eine TopoShape

fuse(TopoShape)

Description: Vereinigung dieser und einer gegebenen Topo-Form.

Returns: eine TopoShape

getAllDerivedFrom( )

Description: Gibt alle Teilsätze dieses Objekttyps zurück.

Returns: eine Liste

hashCode( )

Description: Dieser Wert wird aus dem Wert der zugrunde liegenden Formreferenz und der Position berechnet. Die Ausrichtung wird nicht berücksichtigt.

Returns: eine Zeichenkette

isClosed( )

Description: Überprüft, ob die Form geschlossen ist.

Returns: ein Boolescher Wert

isDerivedFrom(string)

Description: Gibt wahr zurück, wenn der angegebene Typ ein Vater ist.

Returns: ein Boolescher Wert

isEqual(TopoShape)

Description: Gibt wahr zurück, wenn beide Formen dieselbe TShape-Form, dieselbe Position und dieselbe Ausrichtung haben.

Returns: ein Boolescher Wert

isInside(Vector,float,Boolean)

Description: Prüft, ob ein Punkt innerhalb eines Volumenkörpers mit einer bestimmten Toleranz liegt. Wenn der dritte Parameter wahr ist, wird ein Punkt auf einer Fläche als innerhalb liegend betrachtet.

Returns: ein Boolescher Wert

isNull( )

Description: Überprüft, ob die Form null ist.

Returns: ein Boolescher Wert

isPartner(TopoShape)

Description: Gibt wahr zurück, wenn beide Formen dieselbe TShape-Form haben, aber möglicherweise eine andere Position und Ausrichtung aufweisen.

Returns: ein Boolescher Wert

isSame(TopoShape)

Description: Überprüft, ob beide Formen dieselbe Geometrie haben. Der Wert ist wahr, wenn beide Formen dieselbe TShape haben, denselben Standort haben, aber eine unterschiedliche Ausrichtung haben können.

Returns: ein Boolescher Wert

isValid( )

Description: Überprüft, ob die Form gültig ist, d. h. weder null noch leer noch beschädigt ist.

Returns: ein Boolescher Wert

makeFillet(float,TopoShape)

Description: Gibt ein neues Objekt basierend auf TopoShape zurück, jedoch mit einer Verrundung mit dem Radius „float“, die auf jede Kante angewendet wird.

Returns: eine TopoShape

makeHomogenousWires(wire)

Description: Macht dieses und das angegebene Drahtmodell homogen, sodass sie die gleiche Anzahl an Kanten haben.

Returns: ein Linienzug

makeOffset(float)

Description: Versetzt die Form um einen bestimmten Betrag.

Returns: eine TopoShape

makePipe(wire)

Description: Erzeugt eine Welle, indem es entlang eines Linienzugs gleitet.

Returns: eine TopoShape

makePipeShell(wire)

Description: Erstellt einen Loft, der durch Profile entlang eines Linienzugs definiert ist.

Returns: eine TopoShape

makeShapeFromMesh(mesh)

Description: Erstellt aus Mesh-Daten eine zusammengesetzte Form. Hinweis: Dies sollte nur für relativ kleine Meshes verwendet werden.

Returns: eine TopoShape

makeThickness(list,float,float)

Description: Ein ausgehöhlter Volumenkörper wird aus einem Ausgangsvolumenkörper und einer Reihe von Flächen dieses Volumenkörpers erstellt, die entfernt werden sollen. Die verbleibenden Flächen des Volumenkörpers werden zu den Wänden des ausgehöhlten Volumenkörpers, deren Dicke zum Zeitpunkt der Erstellung festgelegt wird. Die zu übergebenden Argumente sind eine Liste der zu überspringenden Flächen, die Dicke der Wände und ein Toleranzwert.

Returns: eine TopoShape

nullify( )

Description: Löscht den Verweis auf die zugrunde liegende Form, die in dieser Form gespeichert ist. Dadurch wird diese Form null.

Returns:

project(TopoShape)

Description: Projizieren Sie eine Form auf diese Form.

Returns: eine TopoShape

read(string)

Description: Liest eine IGES-, STEP- oder BREP-Datei ein.

Returns: eine TopoShape

reverse( )

Description: Kehrt die Ausrichtung dieser Form um.

Returns:

revolve(Vector, Vector, float)

Description: Dreht die Form um eine Achse um einen bestimmten Winkel. Beispiel: Part.revolve(Vector(0,0,0),Vector(0,0,1),360) dreht die Form um die Z-Achse um 360 Grad.

Returns: eine TopoShape

rotate(Vector<position>, Vector<direction>, float<angle>)

Description: Dreht diese Form um einen Winkelgrad um eine durch Position und Richtung angegebene Achse. Beispiel: Shp.rotate(Vector(0,0,0),Vector(0,0,1),180) dreht die Form um 180 Grad um die Z-Achse.

Returns:

scale(float<factor>, [Vector<centre>])

Description: Skaliert diese Form einheitlich um den Faktor. Optional kann der Mittelpunkt der Skalierungstransformation angegeben werden.

Returns:

section(TopoShape)

Description: Abschnitt davon mit einer vorgegebenen Topo-Form.

Returns: eine TopoShape

sewShape( )

Description: Näht die Form, wenn eine Lücke vorhanden ist.

Returns:

tessellate(float)

Description: Die Form tessellieren und eine Liste mit Scheitelpunkten und Flächenindizes zurückgeben. Der angegebene Float-Wert ist die Toleranz.

Returns: a list

toNurbs( )

Description: Umwandlung der gesamten Geometrie einer Form in eine NURBS-Geometrie. Beispielsweise werden alle Kurven, die die Kanten der Basisform stützen, in BSpline-Kurven umgewandelt, und alle Flächen, die ihre Seiten stützen, werden in BSpline-Flächen umgewandelt.

Returns: eine NURBS-Kurve

transformGeometry(matrix)

Description: Wendet eine geometrische Transformation auf eine Kopie der Form an. Die anzuwendende Transformation wird als 4x4-Matrix definiert. Die zugrunde liegende Geometrie der folgenden Formen kann sich zu einer Kurve ändern, die eine Kante der Form stützt, oder zu einer Fläche, die eine Seite der Form stützt. Beispielsweise kann ein Kreis bei Anwendung einer Affinitätstransformation in eine Ellipse umgewandelt werden. Es kann auch vorkommen, dass der Kreis dann als B-Spline-Kurve dargestellt wird. Die Transformation wird auf alle Kurven angewendet, die Kanten der Form stützen, sowie auf alle Flächen, die Seiten der Form stützen. Hinweis: Wenn Sie eine Form transformieren möchten, ohne die zugrunde liegende Geometrie zu ändern, verwenden Sie die Methoden "Translate" oder "Rotate".

Returns: eine TopoShape

transformShape(matrix)

Description: Wendet eine Transformation auf eine Form an, ohne die zugrunde liegende Geometrie zu verändern.

Returns:

translate(Vector)

Description: Wendet die Übersetzung auf die aktuelle Position dieser Form an.

Returns:

writeInventor( )

Description: Schreibt das Netz im OpenInventor-Format in eine Zeichenfolge.

Returns: eine Zeichenkette

TopoShape
transformShape(matrix)

Description: Applies transformation on a shape without changing the underlying geometry.

Returns:

translate(Vector)

Description: Applies the translation to the current location of this shape.

Returns:

writeInventor( )

Description: Writes the mesh in OpenInventor format to a string.

Returns: a string

Einige Attribute und Methoden gelten nur für bestimmte TopoShapes. Diese Elemente gelten für Kanten (TopoShapeEdge).


FirstParameter

Returns: Der Parameterwert an einem Ende der Kante. Nicht unbedingt bei Vertex[0]. Siehe Parameterdarstellung

LastParameter

Returns: Der Parameterwert am anderen Ende der Kante. Nicht unbedingt bei Vertex[1].

getParameterByLength(Gleitkommazahl)

Description: Ordnet das Intervall [0, Länge] dem Intervall [ErsterParameter, LetzterParameter] zu.

Returns: Gleitkommazahl

valueAt(Gleitkommazahl)

Description: Gibt den 3D-Vektor zurück, der einem Parameterwert entspricht.

Returns: Vektor

parameterAt(Vertex,[Face])

Description: Gibt den Parameterwert zurück, der einem Vertex (3D-Punkt) entspricht.

Returns: Gleitkommazahl

tangentAt(Gleitkommazahl)

Description: Gibt den Richtungsvektor der Tangente an der Kante bei einem Parameterwert zurück (sofern vorhanden).

Returns: Vektor

normalAt(Gleitkommazahl)

Description: Gibt den Richtungsvektor der Normalen zur Kante bei einem Parameterwert zurück (sofern dieser eindeutig existiert).

Returns: Vektor

curvatureAt(Gleitkommazahl)

Description: Gibt die Krümmung der Kante bei einem Parameterwert zurück.

Returns: Gleitkommazahl

centerOfCurvatureAt(Gleitkommazahl)

Description: Gibt den Mittelpunkt (3D-Punkt) des oszillierenden Kreises bei einem Parameterwert zurück.

Returns: Vektor


Anwenderdokumentation